home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Aminet 5
/
Aminet 5 - March 1995.iso
/
Aminet
/
mus
/
misc
/
MusicalDice.lha
/
MusicalDiceGameV1.0
/
MusicalDiceGame.doc
< prev
next >
Wrap
Text File
|
1994-12-20
|
8KB
|
272 lines
+-------------------------------------------------+
| |
| M s i D a |
| u c l i G m |
| a c e e |
| |
| |
| |
| v1.0 Copyright © 1994 De Biasi Marzio |
+-------------------------------------------------+
[0] Index:
----------
[0] These :-) lines
[1] What is Musical Dice Game?
[2] MusicalDiceGame program
[3] CLIDice and DiceCommand programs
[4] Infos 'n' Copyrights
[5] Disclaimer
[6] Short history
[1] What's Musical Dice Game?
-----------------------------
The musical dice game (Musikalisches Wuerfelspiel) was created by
Wolfgang Amadeus Mozart in 1791; it allows you to create "random" Waltzes.
The game requires the following: two dice, two number tables (each one with
8 columns and 11 rows), and a note section with 176 individual waltz
measures.
The eight columns of both number tables represent the eight measures of
both waltz sections, the row numbers (2-12) give the possible outcomes
with two dice and the cell numbers give the numbers of the waltz
measures.
The game begins: if, for example, the first toss yelds a 10 then you
search in the first column at row number 10 for the number of the measure:
that's the first measure of your waltz.
Then you toss for the second measure; if you obtain, for example, a 7,
then you find the number of the second measure in the second column at
row number 7. And so on.
>>>> Now you can turn on your Amiga and throw away the dice, the tables
and the measures ... ;-D
[2] MusicalDiceGame program
---------------------------
To start MusicalDiceGame program simply double-click on its icon (a
GREAT icon!).
In the control window you find the following buttons:
BUTTON FUNCTION
~~~~~~ ~~~~~~~~
+------+
| PLAY | : start playing the current waltz
+------+ from first measure
+------+
| STOP | : stop playing the current waltz
+------+
+----------+
| CONTINUE | : continue playing the current waltz
+----------+ from last measure played before stop
+-----+
| NEW | : discard the current waltz
+-----+ and compose a new waltz
+------+
| QUIT | : quit MusicalDiceGame
+------+
It's very easy, isn't it?
[3] CLIDice and DiceCommand programs
------------------------------------
In the archive you find another two programs:
* CLIDice : a CLI version (no GUI) of the MusicalDiceGame
-------
* DiceCommand : a program to send commands to the CLIDice program
-----------
If, for example, you want to play a nice waltz during the execution
of the user-startup, insert the CLIDice command at it's top, and the
DiceCommand quit command at it's bottom:
CLIDice
............................
.... your startup stuff ....
............................
DiceCommand quit
Here it is the syntax of the two commands:
(a) CLIDice [-q]
If you specify -q option, CLIDice will not start playing immediately
(it will wait for a 'DiceCommand play' ).
*** CLIDice will stay in memory until it receives a quit command from
DiceCommand.
*** CLIDice DOESN'T EAT CPU TIME when it's not playing, and when
it is playing eats very few cpu time!!!
(b) DiceCommand <command>
where <command> is one of the following
play : start playing the current waltz
stop : stop playing the current waltz
continue : resume playing the current waltz
new : compose a new waltz
quit : QUIT CLIDice PROGRAM
For programmers:
If you want to build your own CLIDice driver (if, for example, you want
to write a screen blanker that uses CLIDice), then you can find the
simple DiceCommand source code in directory Programmers.
Communications between CLIDice and DiceCommand are made using a
simple message port; DiceCommand has not a reply message port, but
CLIDice checks if the messages it receives contain a non-NULL pointer
to a reply message port and, if necessary, calls ReplyMsg() function.
[4] Infos 'n' Copyrights
------------------------
System requirements
~~~~~~~~~~~~~~~~~~~
Every Amiga with OS 2.0 or higher.
Contents
~~~~~~~~
MusicalDiceGame (v1.0) comes in the lharc archive MusicalDiceGame.lha
which holds th following files:
MusicalDiceGame > GUI version of musical dice game
MusicalDiceGame.info > a great MagicWB icon for MusicalDiceGame
MusicalDiceGame.doc > this documentation
CLI/CLIDice > a CLI version (no GUI) of m.d.g.
CLI/DiceCommand > CLI command to control CLIDice
Programmers/DiceCommand.c > DiceCommand C source code
plus some other .info files
Copyrights
~~~~~~~~~~
MusicalDiceGame is FREEWARE: the archive MusicalDiceGame.lha MAY BE
FREELY DISTRIBUTED, as long as no charges more than reasonable copying
and handling fees are collected!!!
You cannot modify (or leave out) none of its files, and, if you write
a FreeWare or ShareWare program that uses M.D.G., you must distribute
the (original) M.D.G. package with your program.
* This program may be included in freeware collections, providing that the
previous conditions are respected.
* TO SOFTWARE REVIEWS: if you include this program in one of your
disks, please send me a copy of the review, thanks :-)
Bugs & remarks
~~~~~~~~~~~~~~
If you find some bUGS or you want to give me some ideas or remarks
you can send me an email (see below for the Internet address).
Source code
~~~~~~~~~~~
If you want the MusicalDiceGame source code and the original tables,
please send me $10 (US).
My address:
+--------------------------------------+
| |
| De Biasi Marzio |
| via Borgo Simoi, 34 |
| 31029 Vittorio Veneto (TV) |
| Italy |
| |
| E-Mail: debiasi@dimi.uniud.it |
| |
+--------------------------------------+
[5] Disclaimer
--------------
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
[6] Short history
-----------------
During the developement of MusicalDiceGame program I've used:
GadToolsBox (2.0b) Copyright © by Jan van den Baard
OctaMED v2.0 Copyright © by Teijo Kinnunen
MagicWB 1.2p Copyright © by Martin Huttenloher
Thank you very much! ;-)